











* SHERLOCK * 

DISK UTILITY 
V.2.0 

(c) Copyright 1982 by The 4th Works 

With SHERLOCK you can look at any sector on any disk, 
You can change or delete any single or group of bytes 
contained in any sector. SHERLOCK allows you to 
generate a map of the sectors on a disk, so you can 
determine at a glance which sectors have information in 
them and which sectors do not. SHERLOCK can provide 
you with a display of any sector that may have a 
problem, thus making disk repair very easy. The most 
significant function of SHERLOCK is the 
DISK-DISASSEMBLER. This utility allows the 
disasembly of any program on a disk without the 
program being in memory, and be displayed on the 
screen and/or printer. SHERLOCK works with 
non-standard auto-boot diskettes or standard DOS 







SHERLOCK version 2.0 
copyright (c) by 
THE 1TH WORKS 

Congratulations on purchasing what we feel to 1st the finest 
ATARI disk utility program currently on the Market. With SHERLOCK 
you will be able to exaMine any byte in any sector, change any byte 
in any sector, dis-asseMble (froM disk, not core) any Machine 
language file or autoboot disk, Make a sector Map of a diskette, 
fornat disks, search for up to 32 bytes in any sector on a disk in 
either HEX or ASCII forMat, and other useful utilities — all at 
Machine language speed! 

SHERLOCK is a Menu driver, utility, A thourough reading of the 
documentation is recoMMended to fully utilize all of SHERLOCK'S 
features. For novice disk drive users, a short tutorial is included 
— read this carefully for clear understanding. 

SYSTEM requirements: 

ATARI 800/100 

ATARI 810 DISK DRIVE OR 

PERCOM RFD 10 TRACK DISK DRIVE OR 

MFC 10 TRACK DISK DRIVE 

32K RAM (MINIMUM, 18K RECOMMENDED) 

PRINTER (OPTIONAL) 

SHERLOCK is copy protected, The progran is on both sides of 
the supplied diskette, and a backup is available at any tine within 
one year of original purchase for $7,50 conditional upon return of 
registration card within 30 days of purchase. Should your diskette 
fail to boot at any tine within 90 days, return it to HIGH COUNTRY 
MICROSYSTEMS, arid it will be replaced at no charge. After 90 days, a 
noMinal charge of $7.50 will be charged, 
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BOOTING SHERLOCK: 




REMOVE ALL CARTRIDGES. 

Turn on your disk drive. After the busy light goes out. insert 
SHERLOCK and turn on your conputer. THE TTH NORKS logo will be 
displayed, then SHERLOCK'S nenu. Choose the option of your choice, 
enter the number, then press return. 


ATARI is a registered trademark of HARNER COMMUNICATIONS 
TUTORIAL FOR NOVICE USERS 


In using SHERLKK, bytes in a sector are nunbered fron $1 to $80 HEX 
(1 to 128 DECIMAL) arid sectors are nunbered fron $1 to $2D0 HEX (1 
to 720 DECIMAL) 


SHERLOCK is a floppy disk utility progran. A floppy disk is 
nothing nore than a circular piece of naterial with an oxide coating 
capable of storing nagnetic pulses. A fornatted ATARI diskette 
organizes these nagnetic pulses in a specific nanner. There are TO 
concentric rings on an ATARI diskette. These rings are called 
tracks, so the ATARI 810 disk drive is a TO track disk drive. Each 
track, is divided into 18 areas called sectors. Each sector contains 
128 pieces of infornation called bytes. There are a total of TO 
tracks, 720 sectors, and 92,160 bytes on a fornatted Atari diskette. 
Renenber, tracks, sectors, arid bytes are nothing nore than nagnetic 
pulses stored on a diskette. They cannot be seen or felt. Do not 
touch the surface of a diskette, because it is very susceptible to 
danage by body oils, scratches, and dents on their surface. Also, 
do not expose your diskette to any type of nagnetic field, because 
this can destroy any data that is stored on the diskette. Do not 
put your diskettes within 6 inches of a television set (or nonitor), 
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telephone, or any other source of Magnetic fields, SHERLOCK will 
allow you to see the value of any of the 92,160 bytes stored on a 
diskette, and allow you to Manipulate those bytes in any Manner that 
you choose. 

When a diskette is forHatted, 720 blank, sectors are written on 
the diskette. Initially all of these sectors are filled with zeros 
(0). This indicates to the conputer that the diskette is void of 
infornation, yet ready to store inforMation. After the actual 
forMatting process, the DISK OPERATING SYSTEM (DOS) reserves and 
writes to certain sectors on the diskette in sectors 1 through 3. 
The inforMation stored here is called the DOS bootstrap. When the 
ATARI coMputer is turned on, an internal prograM stored in READ 
ONLY MEMORY (ROM) is executed. This prograM checks to see if a disk 
drive is connected to the systen (and turned on). If not, the 
coMputer turns control over to whatever cartridge is in the left 
slot, If no cartridge is in the left slot, the control is turned 
over to the MEMO PAD Mode. If a disk drive is connected and turned 
on, then the diskette in the drive will be read starting with sector 
nuMber 1. The first six bytes in sector nuMber 1 are very 
iMportant. This sector is called the "BOOT SECTOR", If you have 
rot already loaded SHERLOCK, do so row. After the prograM is loaded 
and the busy light on the disk drive is out, renove SHERLOCK and 
return it to it's protective jacket. Now insert a diskette into 
your disk drive on which you know has DOS written on it. Now select 
option nuMber 1 for "DIM 5 SECTOR" arid hit return. Answer the proHpt 
with a "1" arid hit return. Displayed on the screen is the contents 
of sector nuMber 1 in both the HEX and the ASCII for Mats, For now 
ignore the ASCII side. Look, at the first row of nuMbers on the HEX 
side of the screen. WE are only interested in the first 6 pairs of 
numbers. If you have a DOS 2,OS disk in your drive, these nuMbers 
should bet 

00 03 00 07 40 15 

Byte riUMber 1 is not significant, arid is usually 00 or FF, Byte #2 
is the nuMber of sectors to be read into MeHory — the nuMber of 
"BOOT SECTORS", In our exanple there are three "BOOT SECTORS", 
Byte nuMbers 3 and 4 tell the coMputer where in MeMory to start 
storing the incoMing 3 sectors of inforMation. In this exaMple the 
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nenory location is 10700 (HEX). You nay wonder how I got $0700 out 
of 00 07. The reason for this is that the ATARI stores nenory 
location addresses with the low byte first, then the high byte. If 
this is confusing, just renenber that when you are dealing with a 
nenory location address, such as 00 07, all you have to do is 
transpose the two sets of nunbers to get 07 00 -- so, the correct 
address is $0700. Bytes 5 and 6 are also an address. This tells 
the computer what address to go to arid start progran execution AFTER 
all of the "BOOT SECTORS" have been loaded. Therefore, after the 
three boot sectors of this exanple have been loaded into nenory 
starting at $0700, control will be given to the progran starting in 
nenory location $1510. This is a location in the 10K OPERATING 
SYSTEM (OS). All DOS 2.OS disks should have the sane infornation in 
the first 3 sectors. After you've finished reading this tutorial, 
insert an autoboot gane diskette and see how this differs fron DOS. 

The only nunbers that are likely to be the sane are the pair of 
nunbers in byte #1, and as we discussed earlier, this byte, for our 
purposes, is insignificant, _ 


After the fornat process, DOS writes to other sectors besides 
1, 2, 8 3. It writes to sectors 360 to 368 (DECIMAL). This is 
where the VOLUME TABLE OF CONTENTS (VTOC) and the DISK DIRECTORY is 
stored. Use option nunber 1 of SHERLOCK again and look at sector 
$168 ($168 HEX = 360 decinal), All input to SHERLOCK, except for 
nenu selections, is in HEX. For help in conversions, use option 
nunber 9 - "NUMBER CONVERSION"). On a DOS disk, the first two bytes 
are 02 C3. This neans that there are a naxinun of $2C3 (707 
DECIMAL) sectors on the disk available for your use, The next two 
bytes can be anything fron 6 to $2C3. This tells the conputer how 
nany of the $2C3 sectors available to you are actually enpty of 
infornation. The other nunbers seen in this sector tell you which 
sectors on the disk contain infornation and which sectors are enpty. 
For a detailed description of how this works, refer to your DOS 2.OS 
nanual and/or the Technical User's Notes. 

DISK DIRECTORY 
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Sectors *169 through *171 contain the DISK DIRECTORY. These 
sectors contain the nanes of the files on a DOS disk, their length 
and status — locked, deleted, opened, etc. Without the DISK 
DIRECTORY you would not be able to tell what prograns/files you have 
stored on a diskette. If you still have a DOS disk in your drive, 
Lise option number 1 and look at sector *169. The file or program 
starts in byte <06 and the extention in byte *0E, If the progran 
nane does not contain 11 characters (including the extention) spaces 
fill out the nane field. File nanes start every 16 (DECIMAL) bytes 
— allowing for 8 entries per sector. Since there are 8 sectors 
reserved for the DISK DIRECTORY, you are allowed up to 6* (DECIMAL) 
files per diskette. The first byte of every entry is the status 
byte for that particular file. If the file is unlocked the nunber 
will be M2. If locked *62. If deleted *80. Occassionally, a file 
nay be opened for a read operation and before the file is properly 
closed the user will turn off the conputer. Should this happen, the 
status byte will be M3. As far as the conputer is concerned, this 
file dees not exist, The file has neither a "in use" status byte, 
nor a "deleted" status byte, so it is in linbo, and just taking up 
directory space. To regain the directory space, change the status 
byte (using SHERLOCK option nunber 2) to *80. The second and third 
bytes in a directory entry contain the size, in sectors, of the 
file. Again, like an address, low byte first, then high byte (just 
transpose the nunbers like before). The fourth and fifth bytes tell 
you (low/high) the beginning sector nunber of that file. 

SECTOR LINKS 

Wien a file is written to a DOS disk three bytes of each sector 
is reserved for DOS use. These sectors tell DOS how nany bytes of 
infornation is in the current sector, and where the next sector to 
be read is located. The bytes reserved are bytes *7E,7F, and *80. 
Mien you write a file to a diskette, DOS will try to write that file 
in contiguous sectors. If there are not enough contiguous sectors 
available, the DOS will look for available enpty sectors to write 
the renairider of the file. Because you can't count on one sector 
calling the next sequential sector, you nust have a way to tell DOS 
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where to find the next correct sector to load. Again, to understand 
precisely how the last three bytes are used, consult the DOS 2 
Manual and/or the Technical User's Notes. 

The preceeding was Meant to be a very fast and dirty tutorial 
on the structure of ATARI DOS diskettes. For More inforMation, 
carefully read the DOS 2 Manual and the portion of the Technical 
User's Notes dealing with disk booted software. 

INSTRUCTIONS FOR USING SHERLOCK 


NOTE! Any tine there is a chance of writing to the wrong disk, as in 
editing, copying, arid fornatting, SHERLOCK will display a RED BORDER 
as a warning. 


1) DUMP SECTOR 

Select option nunber 1. You will then be asked which sector 
(in HEX) you would like to have displayed to the screen. Enter the 
sector number arid hit return. On the left is the HEX representation 
of the sector, and to the right the ASCII representation. To dunp 
the screen contents to 3 printer press "P", Press either the left 
or right arrow keys to see previous or following sectors. Should 
you atteMpt to view non-existant sectors (less than $1 or greater 
than $2D0) SHERLOCK will return to the Main Menu. To return to the 
Main Menu press any key other than "P" or the left and right arrow 
keys. 


2) EDIT SECTOR 

Select option number 2. Enter the sector number you wish to 
edit and press return. You will be 3sked if you would like to zero 
the sector -- answer yes or no. Now you will be asked if you want 
to edit in the HEX or ASCII node. Unless you choose the "A" option, 
the progran will default to the HEX Mode, In the HEX Mode, 0 
through 9 and A through F are legal keys. All others are trapped 
out. In the AJ£II Mode, all keys except arrow keys, are legal. In 
either Mode, cursor MoveMent is achieved by using the four arrow 
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keys and holding down the CTRL key. Change the sector infornation 
in any wanner you wish. Mien completed, press return. You will be 
asked if the changes are correct. If you answer no, the sector will 
be re-read fron the disk arid displayed. If you answer yes, you will 
be asked if you want to write the sector with your changes back to 
the disk in the sane location. Answer yes and the sector will be 
written arid you will be returned to the wain nenu. Answer no and 
you will be asked what sector you want to write the infornation to. 
The infornation will then be written to the location you specified 
and you will then return to the nain nenu. If you realize that you 
don't want to write to the disk at all and just want to abort the 
option, enter a zero (0) for the sector to be written or press 
SYSTEM RESET. 

3) DISK HAP 

Select option nunber 3. After return is pressed, what ever 
diskette is currently in the drive will be read and a graphic 
representation of it's contents will be displayed on the screen. An 
asterisk. (*) indicates that a sector has valid infornation in it 
(non-zero), A period (.) neans the sector is totally enpty (all 
zeros). A hyphen (-) indicates that the sector is unfornatted or 
bad. Each row of I's, ,'s, arid -'$ represent 2 tracks. After the 
nap is conpleted, a hex nunber index is displayed on the left side 
of the screen to help you locate the sectors you are interested in. 
Should you wish to abort the nap before conpletion, just hold any of 
the yellow keys. 



NOTE! For users who do not have a DATA SEPERATOR installed in 
their disk drive. Occassionally, the nap will indicate that you 
have unfornatted sectors in the last two or three tracks on a disk 
you know to be good. This is not an error in SHERLOCK, but a 
problen with your disk drive. There are two solutions to this 
problen. 1 -- Go to your nearest ATARI Service Center and have a 
DATA SEPERATOR installed or 2.— Recognize the problen and live with 
it. If you are having problens reading sectors in other tracks, and 
you know the disk being napped does not have unfornatted sectors, go 
to an ATARI Service Center and have your disk drive speed checked 
and corrected. 
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1) DISK DISASSEMBLER 

Select option number $. You will be asked if you want a print 
out of the disassembled code. Answer yes or no. Input the sector 
number to start disassembly. If you enter sector 1. then you will 
be asked if you want to use the first six boot bytes -- answer yes 
or no. If this point is confusing, refer to the tutorial supplied. 
Now. enter the address of the first byte in the sector you choose to 
disassemble. Now enter the address of where you want disassembly to 
begin. This may seem rather confusing, however, there is a purpose, 
Suppose you know the beginning addres of sector $1 is $0700 and you 
really want to look at the code beginning at $0900. Answer 1 for 
the sector to start disassembly. Answer yes for the boot bytes, 
Answer $0700 for the first byte in the sector. Answer $0900 for the 
address you want to disassemble from. SHERLOCK will figure out 
where $0900 would be in relation to the beginning address of $0700, 
In this example, $0900 is located in sector 5. 

If you have not choosen the print option, you must press the 
START key for the disassembly to continue. The disassembly to 
screen is relatively fast. If you see a portion of code you want to 
examine more closely, release the START key, and the disassembly 
will pause. To continue, press the START key again, To abort and 
return to the menu press the SELECT key. 

If you did select the print option, then holding the START key 
could be inconvenient, especially if you wish to print several pages 
of disassembly. With this option, disassembly will start and 
continue until the option is aborted with the SELECT key. In the 
print mode, the disassembly will be displayed to the screen as well 
as the printer 

5) DISK SEARCH 

Select option number 5. You can search for up to 32 bytes in 
either HEX or ASCII mode, You will be asked if you would like to 
search for HEX or ASCII. Unless you specify ASCII, you will default 
to HEX. If you are in the HEX mode, just enter the HEX code to be 
searched for, Make sure you type a space between each pair of 
numbers. For example, if you want to search the disk for the code 
LDA *$21, the HEX code would be A9 21. That is what you would enter 
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— A9 21* You will be asked which sector you want the search to 
begin with. When a natch is found, the sector will be displayed to 

the screen — in the sane fornat as the Dump Sector option, with an 

arrow pointing to the first byte of the sequence you were searching 

for, You will be asked to enter a "Y", "N", "P", or "D". If you 

want to continue the search for the sane sequence, enter "Y"» If 
you do not want to continue the search enter "N". If you want to 
print the screen contents enter "P". If you wish to see the code in 
disassenbled forn enter "D". Answer "N" and you will be asked if you 
want to edit this sector. "Yes” will put you into the EDIT SECTOR 
node — fron here follow the directions for option nunber 2. A "D" 
option will display the code you were looking for arid a few bytes of 
following code in disassenbled forn. You will then be asked if you 
want to continue the search or print the screen contents. 

If you want to search for an ASCII string, answer "A", then 
input EXACTLY what you are looking for. For exanple, if you want to 
know where, on a DOS disk, the phrase "Write DOS Files" is located, 
then enter "Write DOS Files". 

6) DISK COPY 

Select option nunber 6. This is basically a straight forward 
copy utility, pronpting for source arid destination disks, This copy 
utility is intelligent. It will read as nany sectors as the buffer 
size allows, If a source sector is enpty, then it is not stored. 
Since SHERLOCK takes approximately 26K to run, there is a 22K buffer 
in a 48K conputer. If the disk being copied is less than 22K the 
copy will be acconpliched with one pass. A naxinun of 5 passes is 
required if the source disk is full. If while copying, an error is 
encountered fron the source disk., you will be pronpted to insert the 
destination disk. After the buffer has been written out, you will 
be told which sector was not read. 

You will be given four choicest 

1) Retry Sector 

2) Continue (with next sector) 

3) Skip (to next) track 







1) End copy 


Should there be an error in writing to a disk, you will be 
asked if you would like to retry the write. 

The Disk Copy utility was included in SHERLOCK as a convenience 
to the user. Should you require a dedicated copy utility with a 18K 
buffer, inquire fron your local conputer dealer about COPY CAT fron 
HIGH COUNTRY MICROSYSTEMS. This is a high perfornance Machine 
language disk, copy utility. 

7) DISK DIRECTORY 

Select option nuMber 7. This gives a Disk. Directory for DOS 
diskettes. InforMation given includes the file naMe, status of the 
file, starting sector, length of file, 3nd the file nunber. If you 
want a print out of the directory, just press "P", 

8) FMS SECTOR TRACE 

Select option nuMber 8. This is a utility to trace sector 
links for DOS files. Enter the file nunber deternined by option 
nuMber 7, arid the sector link trace will be displayed. Press "P" and 
the screen display will be printed. 

9) NUMBER CONVERSION 

Select option nunber 9. Select i or 2 for the option you want 
then enter the nunber you want to convert. The Unit of accuracy 
for conversion is iFFFF for HEX and 65535 for DECIMAL, Any inputs 
beyond this range will result in invalid conversions. 

10) FORMAT DISK 

Select option nunber 10, This option is really neant as a 
conplinent to the Disk Copy utility, This option will fornat a 
diskette, but will not write the DOS boot sectors or set up the VTOC 
and Disk. Directory, If you reed a fornatted diskette for the copy 
routine, then this fornat is fire, because every sector is copied, 
If you need a fornatted diskette for use with DOS files, do not use 
this fornat. Boot a DOS disk, arid fornat with option I. 
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11) SET DISK DRIVE 

Select option nunber 11. By using this option you can have 
SHERLOCK coMHunicate with up to 1 ATARI 810 Disk Drives or Percon 
RFD or HPC drives. 




LIMITED WARRANTY 


This software product and the attached instructional 
materials are sold "AS IS," without warranty as to their 
performance. The entire risk as to the quality and 
performance of the computer software program is 
assumed by the user. The user, and not the 
manufacturer, distributor or retailer assumes the 
entire cost of all necessary service or repair to the 
computer software program. 

However, to the original purchaser only, HCMS 
warrants that the medium on which the program is 
recorded will be free of defects in materials and faulty 
workmanship under normal use and service for a period 
of (90) days from the date of purchase. If during this 
period a defect in the medium occurs, the medium may be 
returned to HCMS or to an authorized HCMS dealer, and 
HCMS will replace or repair the medium at HCMS's 
OPTION without charge to you. Your sole and exclusive 
remedy in the event of a defect is expressly limited to 
replacement or repair of the medium, as provided above. 
To provide proof that you are the original purchaser, 
please complete the enclosed warranty card and mail to 
HCMS. 

If failure of the medium, in the judgement of HCMS, 
resulted from accident, abuse or misapplication of the 
medium, then HCMS have no responsibility to replace or 
repair the medium, under the terms of the warranty. 



SHERLOCK 


DISK UTILITY 

- DISK-DISASSEMBLER 

- MACHINE LANGUAGE SPEED 

- SECTOR DUMP IN (HEX OR ASCII) FORMAT 

- CHANGE OR DELETE BYTES IN SECTORS 

- COMPLETE MAP OF STANDARD AND 
NON-STANDARD SECTORS 

- WORKS WITH ALL FORMATS 

- 32 BYTE SEARCH CAPABILITIES 

- SECTOR DISK COPY UTILITY 


ALL THIS IN ONE VERY POWERFUL 
PACKAGE. 



(c) Copyright 1982 by The 4th Works 
All rights reserved H.C.M.S 





